MEMO 


TO: Jeff Porter -———. 

CC: Gail Wellington Jeff Scherb (no software) 
FROM: Benjamin Phister 

DATE: 14 February 1992 

RE: _ SimCD and CDTV Tools Vol. 2 


_ Jeff, please find attached a copy of Carl Sassenrath’s SimCD program, and its documentation. 
This simulator lets a standard Amiga 2500 or A3000 run the CDFS off a SCSI drive, emulating 
the data transfer rate of CD’s. Carl intends to implement a simulation of CD seek times as 
well, in a future revision. 

| also attach a copy of the latest CDTV Tools disk, which is about to go into beta testing. 
Please circulate these to the appropriate people in Engineering. 


Best regards, 
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SimCD 


A Simulator for 
CDTV Application Development 


Beta Release 1 (7 Feb 92) 


NOTE: This will be updated very soon to utilize the 
actual SimCD user interface and other special 
features.... Limit distribution only to key developers. 


By Pantaray, Inc. 
Phone: (707) 462-4878 


Copyright 1992 Commodore International, Ltd. 
Confidential 
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SimCD is a software simulator that converts your favorite 
Amiga Computer into a powerful testbed for CDTV 
application development. 


Since the foundation of CDTV is based entirely on the 
Amiga system hardware and software, simulating it on an 
Amiga is quite natural. With the addition of a few special 
software modules, the Amiga can be made to function in a 
manner nearly identical to CDTV. This allows you to test 
your application software on the same machine you use to 
produce your application. This greatly enhances your 
productivity by eliminating many of the time consuming 
steps necessary to prepare for functional testing. 


Because the CDTV and Amiga have identical hardware 
architectures, many types of system simulation are 
possible, depending on the qualities you wish to test. In 
order to provide a more timely release of SimCD, the 
accuracy of simulation has been subdivided into several 
levels. Each higher level will provide a more accurate 
and complete degree of simulation. 


This release of SimCD (Level 1) is meant to provide a 
quick means of discovering functional programming 
errors or evaluating the approximate performance of an 
application. Also, because SimCD can execute on a 68030 
machine, it permits the use of essential system debugging 
tools like the Enforcer (a must!). 


Simulation at this level includes support for the CDTV 
File System, CDTV device driver, Bookmark/Cardmark 
device driver, Debox library, and Preferences library. 
CDXL is also supported. In addition this level provides 
mock input of the CDTV IR remote control data stream. 


This document assumes that you are fully familiar with 
the Amiga Operating System, including the setup and 
partitioning of hard disk volumes. 


SimCD operates by pretending that your hard disk is 
actually a CD-ROM. Because it accesses your hard disk 
directly at the logical sector level, improper setup or use of 
this simulator can totally destroy data on a hard disk. This 
can lead to frustration, depression, and other unhealthy 
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mental states. Documentation, hard disks, and even 
people have been thrown out of windows as the result of 
simple, easy to type, but devastating hard disk mistakes. 


The Simulator will attempt to shield you as best it can by 
checking whether certain actions actually make sense, but 
it will always be up to you to make the final decisions. Be 
certain that you understand what you are doing. Don't 
makes guesses, unless you are willing to risk the loss of 
your work. If there is any doubt in your mind that 
something might not be quite right, make a complete 
backup of your system first. 


SimCD can operate from a either a specially initialized 
disk partition or a separate disk drive unit. If you are 
paranoid, choose the latter. If you are an expert, or if the 
data on your disk doesn't mean much to you, the former 
will save you some financial expense. 


Suggested Hardware/Software 


Distribution 


Although it should be possible to run the simulator on 
any Amiga equiped with a hard disk, such an approach 
may not make much sense. We suggest the minimum 
hardware of: 


¢ 68030 CPU running at >14 MHz 

¢ 1 Megabyte of chip memory 

e At least 2 Megabytes of total memory 

¢ 200 Megabytes or more of hard disk storage 
e System Release 2.04 or better 


We have not yet tested the simulator on AmigaDO$S 1.3 
with a 7 MHz 68000, so we don't know if it works. We 
suspect that the system might have problems keeping up. 
If you are so determined to find out, please let us know so 
we can update this document. 


The SimCD distribution disk contains the following 
directories and files: 
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SimCD — modules and tools for SimCD 
InstallISO — install a CD-ROM image on a disk 
FakIR — fake the CDTV IR stream 
ConfigSim — configure the simulator 
(temp program, soon to be replaced, see below) 
BookFile — initialize the bookmark device & 


load/save bookmark images 


Devs — disk loadable device driver modules 
cdtv.device -— a simulation of this device 
bookmark.device — a simulation of this device 


(debox & playerprefs not in this release) 


L — disk loadable DOS handlers 
CDFS —- the CDTV ISO-9660 file system 


Example 
ControlFile - example control file for Buildtrack 
Example.iso — example ISO image to try 


Example.toc — example CD table of contents 
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Initial Disk Setup 
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This section describes how to set up the CDTV simulator 
on your Amiga. To do this you will need to copy the 
simCD modules onto your system and create the 
necessary hard disk partition. 


A very simple CLI shell script has been provided to help 
you install the simulator on your Amiga. This script will 
copy the file system, libraries, and devices to their correct 
locations on your system. The script isn't too brainy, so 
you may wish to review it before running it. (We will 
convert it to use the installer later). If you type: 


execute df0:simcd.install dh0:SimcCD 


the script will copy the simulator devices to to the DEVS: 
assignment, CDFS to the L: assignment, and libraries to 
LIBS:. It will then create a directory called SimCD on DHO: 
(or whatever you want to call it) and copy the simulator 
tools there. You may want to update your startup- 
sequence to add a path to this directory, to simplify the 
execution of simulator commands. 


To begin simulation, you will need to make a few 
important decisions regarding the configuration of your 
hard disks. To simulate the CD-ROM, SimCD requires 
that you provide adequate disk space to hold the entire 
ISO disk image — as either a disk partition or a separate 
drive. Unlike the emulator, extra space is not required for 
error correction data, the hard disk's own error correction 
is used. 


The HDToolBox program (or any other such program) can 
be used to partition your disk and setup your drive. Do 
this as you would normally for an AmigaDOS partition or 
drive. 


Once this has been done you must decide how you want 
to install the CD File System. Two alternatives are 
possible: make CDFS a foreign file system which gets 
mounted automatically during system boot; or provide an 
explicit mountlist entry for it. The former tends to be the 
easiest and is less error prone; however, your choice may 
depend on what you are more familiar with. 
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If you are using HDToolBox to setup your disks, the CDFS 
foreign file system can be added with the following 


procedure: 

1. Select the drive where you want the ISO partition. 
2. Click on the "Partition Drive" gadget. This will 
take you to the drive partitioning control panel. 

3. Select or create the partition to contain the ISO 
image. Be sure to make it large enough. Change its 
name to "CD0O". 

4. With this partition still selected, click on the 
"Advanced Options" gadget to gain access to the file 
system options. 

5. Click on "Add/Update File Systems". This will take 
you to the file system maintenance control panel. 

6. Click on "Add New File System". A requester will 
appear. 

7. In the Filename field of the requester, enter 
"L:CDFS" 

8. In the DosType field, enter the value "0x43443031" 
(CD01). 

9. In the Version field, enter the value "25" 

10. Click on "OK". CDFS should appear in the list 
requester. 

11. Click on the "OK" gadget. This will take you back to 
the partitioning control panel. 

12. Click on the "Change File System for Partition" 
gadget. This will take you to the File System 
Characteristics control panel. 

13. Click on "Custom File System". This will also 
enable the "Identifier" string gadget. 

14. Click in the "Identifier" string gadget. Erase the 
current value and enter the value "0x43443031". 

15. Click on "OK". This will return you to the 
partitioning control panel. 

16. Click on "OK". This will return you to the drive 
selection panel. 

17. Click on "Save Changes to Drive." This will write 


the new RigidDiskBlock out to the drive. Be sure to 
do this before rebooting! 
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18. Reboot the system. The CDFS partition should now 
be available. If you type "Info" you should see an 
indication of this; however, without an ISO image 
“you will not be able to access the partition. 


To mount the file system explicitly you will need to create 
a mountlist entry. This is done in a manner identical to 
specifying a partition using one of the standard file 
systems. You will need to know where you want to put 
the partition, how large it is, what SCSI unit it's on, etc. 
An example of a mountlist entry utilizing CDFS might 
appear as follows (this is just an example, so you must 
modify it for you system!): 


CDO0: 
Device = scsi.device 
Filesystem = L:CDFS 
Unit = 6 
Flags = 0 
Surfaces = l 
BlocksPerTrack = 49 
LowCyl = 1500 
HighCyl = 2085 
Reserved = 0 
Mount = 1 
GlobVec = -1 
StackSize = 4096 

# 


For the above mountlist entry to work, you must be sure 
that CDFS is installed in the L: directory. The ‘Filesystem’ 
field in the mountlst points to it correctly. Finally, 
mount the file system using the 'Mount’' command. The 
volume will then be available. 


Installing an ISO Image 


Before you can proceed to access the CDFS partition, you 
will need a valid ISO image for the file system to 
recognize. The SimCD distribution disk contains a small 
example image that can be used to test your setup. 


ISO image files can be copied to the CDFS partition with 
the InstallISO command. This command transfers the 
ISO image file to raw sectors of an AmigaDOS partition. 
The CDFS filesystem must be mounted before this 
command can be used. 
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The arguments to the command are simple: 


InstallISO <FileName> <DOSDev> 


so, to install the example iso image: 


InstallISO example.iso CD00: 


WARNING: This command will overwrite disk data on 
the specified partition. Be absolutely certain that you 
know what you are doing. If you have any doubts, settle 
them by making a backup of your system first. 


After copying the ISO image to the partition, issue a 
‘DiskChange' command to cause the filesystem to 
recognize the new data: 


DiskChange CD00: 


You should now be able to access CD0O: with the info, dir, 
list commands, or even your own programs. The 
simulator version of CDFS can execute without the need 
for any of the other SimCD modules to be installed. You 
can leave this partition installed in your system for 
normal Amiga operation. It will function just like a 
normal file system (perhaps a bit faster in some cases). 
The data on this volume are write protected as if it were a 
real CD-ROM. 
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Once installed the simulator is ready for use at any time 
on your Amiga. The modules of the simulator will be 
loaded into the Amiga automatically as they are required. 
They will stay resident in memory until your system is 
rebooted. 


[ The simulator has a visual interface which has yet to be 
completed and is not available with this Beta release. This 
actually makes little difference however, the simulator is 
just as useful with the CLI equivalent commands.) 


The installation of the CDFS has been discussed above. 
Use it as you would on the CDTV or any Amiga. Try 
typing the CLI INFO command, DIR and LIST commands, 
etc. 


Within your application CDFS is accessed whenever you 
scan a directory or open a file on the CD0: volume. In this 
level of the simulator, you have some degree of control 
over the speed of the CDFS. 


This module simulates the cdtv.device found within the 
CDTV ROMs. While not perfect the device simulates CD- 
ROM reading speeds to a very high degree (seek times are 
not yet simulated). CDXL is supported. CD digital audio 
commands do not yet produce any audio output, but the 
tracking of the laser over the disc is simulated, and 
CDTV_SUBQ commands will report the correct disc and 
track positions. A simulated TOC (Table Of Contents) is 
also provided. 


This module uses a hard disk partition for simulation. To 
inform cdtv.device of the partition it is to use, it must be 
configured with the ConfigSim program. If not 
configured, cdtv.device will not open. 


Note: this module of the simulator requires the CIA timer 
for correct 75 Hz sector timing. If the program being tested 
also uses this timer, problems may exist. 
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This program configures cdtv.device for use. It informs 
cdtv.device which partition to use for simulation. The 
program is invoked as follows: 


ConfigSim <dosdev> <tocfile> 


The first argument is the name of the DOS partition that 
you installed your ISO image into. The second argument 
is the name of a table of contents (TOC) file. This is 
simply a file with text lines describing the type and size of 
each CD track. For example: 


Data 20000 
Audio 30000 
Audio 40000 


indicates a CD-ROM track of 20000 sectors, and two Audio 
tracks with the given number of frames (sectors). No 
comments are currently allowed in this file. 


If you have reserved the DOS partition named "CD0:" for 
simulation, you could start device simulation with: 


ConfigSim CD00: example.toc 


(Note: The next release will eliminate the need for the 
TOC file if you are not using audio tracks...) 


Bookmark/Cardmark Devices 


BookFile 


The bookmark device is used to store information 
intended to survive CDTV reboots. Applications include 
game high scores, saved positions in a large database (such 
as an encyclopedia), debugging flags, etc. See the 
bookmark documentation for more detail. 


The simulator version of bookmark.device has been 
modified to operate as an ordinary disk-loadable shared 
device. 


Note: This version also does nothing when its Expunge() 
vector is called. This is so that the bookmarks will not be 
purged. 


BookFile is a utility to manipulate entire bookmark 
memory images. The entire contents of the bookmark 
memory is either loaded from a file or saved to a file, 
depending on the command line switches. 
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Note that bookmark and cardmark images may not be 
intermixed. 


Bookfile's usage is: 


BookFile -{sl}[c] <filename> 


The command line switches are: 


S Save contents of bookmark memory to 
<filename>. 

1 Load bookmark memory with the contents of 
<filename>. The previous contents of 
bookmark memory are lost. 

c If this option is supplied, the 
cardmark.device is used instead of the 
bookmark.device (default). 


Using Bookfile might take the following forms: 


BookFile -l Gametest.book 


BookFile -sc cardmem 


FakIR is a simple utility that simulates the behavior of 
CDTV's infrared remote controller. In particular, the 
PLAY/PAUSE, STOP, FF, REW keys and the joypad are 
simulated. 


FakIR is run from the command line and is halted by 
pressing CTRL-C or by using the 'Break' command on it. 
In addition, FakIR's operation may be suspended and re- 
enabled by pressing Ctrl, left Shift, both Alt keys, and 
typing the toggle character (default: '1’). 


When FakIR is active the arrow keys on the keyboard 
mimic the IR joypad. The PLAY/PAUSE, STOP, FF, and 
REW keys are mapped to the following function keys: 


STOP Fl 
REW F2 
PLAY/PAUSE F3 
FF F4 


When one of the above function keys is pressed, the 
rawkey code for the respective IR key is sent. The unusual 
behavior of the FF and REW keys is also simulated. 


Note that the simulation is not perfect, but is intended to 
give you a "feel" for how your title will run with CDTV 
controls without having to actually test it on one. 
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